home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 1 / Gold Medal Software Volume 1 (Gold Medal) (1994).iso / prog / zeus.arj / ZEUS.TXT < prev    next >
Encoding:
Text File  |  1993-07-27  |  13.6 KB  |  347 lines
  1.                             ZEUS - THE IDE FOR CLIPPER  
  2.                             UNREGISTERED VERSION - SHAREWARE
  3.                             <C> A.W.BELL 1992 - 1993
  4.                                       MKII
  5.  
  6.  
  7. Zeus is an integrated IDE for Clipper developers.
  8.  
  9. Imagine having a text editor that auto-indents your code, re-indents it 
  10. should you tinker with it,will allow access to your databases in order to 
  11. paste field names and alias's into your program,will compile and link (with 
  12. the linker of your choice) and then run your program (under the debugger if 
  13. required) all from within the IDE. If you can imagine this then you are 
  14. imagining Zeus!
  15.  
  16. More than that, Zeus comes complete with a Database Utility that fully 
  17. supports the new IDX and CDX drivers, a Screen designer and CODE-GENERATOR 
  18. that will generate the code for these screens, including GETS to Database 
  19. Fields!
  20.  
  21. Zeus has a built in Calculator for simple maths and a mini spreadsheet for 
  22. the complex stuff.
  23.  
  24. Yet Zeus is 99.99% Clipper code. There is just a smidgen of Assembler to do 
  25. the things Clipper cannot - like determine the disk drive Zeus was called 
  26. from etc.
  27.  
  28. Zeus shows that the much maligned MEMOEDIT function can and does provide the 
  29. block on which to build a decent text editor. The ONLY limitation is that 
  30. files cannot be more than 64K long, but this is not so important for a 
  31. program editor - it actually encourages shorter modules and makes for better 
  32. programming style.
  33.  
  34. On top of this, Zeus can be used as a mini wordprocessor, with word wrap and 
  35. adjustable line lengths.
  36.  
  37. Zeus has limited mouse support - for positioning the cursor and copy / paste 
  38. routines.
  39.  
  40. This copy of Zeus is UNREGISTERED. It is provided as SHAREWARE and has no 
  41. limitations whatsoever. Please support the shareware concept - if you like 
  42. and use this product, please register. Also feel free to pass the ZEUS.zip 
  43. file UNALTERED to anyone and everyone.
  44.  
  45. To register - send me just £15 to A W Bell 26a Meadow Way Reigate Surrey RH2 
  46. 8DR ENGLAND.
  47.  
  48. In return for your small contribution you will receive:
  49.  
  50. A copy of ZEUS.LIB which will enable you to use my menu functions and   
  51. other goodies - mouse driver, progresss meter, quick memo line count,  
  52. append to database with progress meter etc
  53.  
  54. An offer of Zeus for Windows at a reduced rate (once I've finished    
  55. writing it - it may be a while.... )
  56.  
  57. You will be notified of improvements to Zeus and offered these at a cut 
  58. down rate.
  59.  
  60. Notification of when ZEUSPDK (Project Development Kit) is available, 
  61. again at a cut down price. The Zeus PDK will have these features: 
  62.  
  63. All program files stored in an encrypted form - prevents prying eyes
  64.  
  65. TOTAL history of program development and instant recall of previous program 
  66. files - now edits can be made with an assured backup available
  67.  
  68. A DataDictionary to store Database definitions and recreate these at will
  69.  
  70. A code generator to manage Database movement - in both Clipper5.X syntax as 
  71. well as Class(y) objects. This code generator will produce REAL OPTIMIZED 
  72. code. Those of you that have used other code generators - you know, the ones 
  73. that clain to cut program by vast amounts - will appreciate that they 
  74. generate 1000's of lines of code that runs like a snail on the way to its 
  75. own funeral. Not Zeus. Zeus PDK will produce the stuff that runs as fast as 
  76. if you wrote it yourself.
  77.  
  78. It will do this because it is being written by someone (me) who will be 
  79. using the results himself.
  80.  
  81.  
  82. GETTING STARTED.
  83.  
  84. You should have placed Zeus in its own directory and placed this directory 
  85. in your PATH statement. This will allow Zeus to edit any text file on your 
  86. system from anywhere and still be able to access its help and default 
  87. databases.
  88.  
  89. At the command line type:
  90.  
  91. ZEUS NEW to edit a new, empty file
  92. ZEUS file To edit an existing file (64K max length)
  93. ZEUS to edit the last saved file
  94.  
  95. You will see, on your first entry to Zeus, a blank edit screen and a few 
  96. status features on the bottom row. The top right will show that INSERT mode 
  97. is on.
  98.  
  99. You can start entering your program right away. You may notice that certain 
  100. keywords are indented - try typing a DO WHILE - ENDDO routine, or a FOR - 
  101. NEXT routine. Zeus handles the indents for you. (You can stop it from so 
  102. doing if it annoys you.)
  103.  
  104. Zeus can also prevent those errors that occur when you type a number of ('s 
  105. and dont provide enough )'s. Whenever you type a ( or a { or a [, Zeus will 
  106. provide the closing brace and place the cursor in the right spot. It takes a 
  107. little getting used to, but is a real boon after a while. (This can also be 
  108. switched of it it bugs you).
  109.  
  110. To save your masterpiece, press F9. You will be asked if you wish to save 
  111. the file and to enter the name. Once you have done this, renter Zeus. Zeus 
  112. will now open up this file and replace the cursor exactly where you left 
  113. off. Not only is this convenient, its a blessing when you're trying
  114. to eradicate a bug in Line 1459 and whatever you do, the bug wont shift. At 
  115. least every time you return to Zeus you will return to this bit of code 
  116. immediately, without having to scroll down or do a search.
  117.  
  118. FUNCTIONS
  119.  
  120. Zeus does not have any menu structures. Because its primary aim is that of 
  121. an editor / IDE, Zeus has been configured to give priority to the MEMOEDIT 
  122. group of functions. When you come to use the Database Utility you'll see 
  123. that its TBrowse is no speed demon. This is the trade off - fast memoedit 
  124. slows down other 'heavy' functions.  In order to keep the overheads to a
  125. minimum, all Zeus functions are called from the Function keys or a 
  126. combination of the ALT key with another key. Below are listed these keys.
  127.  
  128. FUNCTION KEYS
  129.  
  130. F1 - Context sensitive help. Where none exists, you will receive a list of 
  131. avaialable topics.
  132.  
  133. F2 - Toggle between 25 and 50 line modes (VGA required). The 50 line mode is 
  134. usefull for
  135. scanning long, difficult routines and is a good eyesight tester.
  136.  
  137. F3 - Toggles active windows - If you have more than one window open, F3 will 
  138. switch control
  139. to the next open window.
  140.  
  141. F4 - DEFAULTS. Pressing this allows you to change the Defaults for the 
  142. current session - you can enter the file extension for the File manager, the 
  143. line lenght of the text file (changeable at any time), the format pad length 
  144. (this works for reformat only - not autoformat). You can set the tab size 
  145. and enter a file path for the Database Field Name extractor - handy for when 
  146. the program uses DB's in another directory. You can turn off / on the auto 
  147. pads and brace expansion, and change the screen colour. These defaults are 
  148. for the session only. with the exception of colour, which is retained for 
  149. future sessions.
  150.  
  151. F5 - FILE MANAGER. This gives access to all files in all directories. The 
  152. file names are on the left, the Directories and paths are in the middle and 
  153. the filename and extension settings are on the right. The default search is 
  154. the current directory foer all files with the extension '.PRG'. NOTE, it is 
  155. necessary to enter the '.' in the file extension. Use the cursor left and 
  156. right keys to navigate these 3 categories and the up and down keys to select 
  157. files and change directories. NOTE - the files and paths are not sorted into 
  158. alphabetical order - this cuts out quite a large delay. However, the files 
  159. can be selected quickly by pressing the first letter of the filename.
  160. NOTE - any named file in the selected window is automatically saved on 
  161. pressing F5 
  162.  
  163. F6 - COMPILE - LINK - RUN. This is one of the main IDE fetaures, the ability 
  164. to do all the work within the editor. You firstly select which of the 3 
  165. options to perform (or select any combination of these). If you chose to 
  166. complie, you will be asked to enter any compiler switches required. You will 
  167. then be asked to pick a linker. If you chose to link, you can then enter the 
  168. link line (excluding thr linkers name). If you chose  a run command you can 
  169. then enter the run command.
  170.  
  171. You will be asked to confirm the link and run commands - in case of compile 
  172. or link failure.
  173.  
  174. The compile function will only compile the current file - to do a different 
  175. one, use the run command.
  176.  
  177. F8 - Database Field Grabber - this will first display a list of all DB's in 
  178. the current directory, or the path you set using F4. Select the file and the 
  179. fields appear. Select a field and this will be pasted into your document. 
  180. Use ESC to cancel any of the operations.
  181.  
  182. F9 - Save and exit. (Any named file will be saved automatically)
  183.  
  184. F10 - search function. Enter the search text and press enter. If its found 
  185. the cursor will go there, otherwise you will be informed no matches exist. 
  186. NOTE this searches from the current cursor position to the end of the 
  187. document. (see ALT_F10) 
  188.  
  189. F11 - Case sensitive search and replace. NOTE this replaces ALL found 
  190. occurrences and must be used with caution.
  191.  
  192. F12 - Toggle window display. If one window is displayed, pressing this 
  193. changes the display to 2 windows, if 2 are displayed this changes it to 4. 
  194. If 4 are dsplayed, this returns it to 1. (See ALT_F12)
  195.  
  196. ALT KEYS
  197.  
  198. ALT_F2 - Database utility
  199.  
  200. ALT_F7 - Rename file
  201.  
  202. ALT_F12 - Make current window full screen
  203.  
  204.           BLOCK MARKERS - COPY & PASTE
  205.  
  206. ALT_B
  207.  
  208. This places up to 2 block markers in the text. Place the first block at the 
  209. befinning of the text to be copied and the second at the end. The Right Hand 
  210. mouse button will place these as well.
  211.  
  212. ALT_K
  213.  
  214. Copies the text between the markers into the text buffer.
  215.  
  216. ALT_M
  217.  
  218. This places the insert marker into the text. (The right hand mouse button 
  219. will do this once both block markers have been placed). The arrangement of 
  220. insert markers allows for the text in the buffer to be simultaneously placed 
  221. in several locations.
  222.  
  223. ALT_I
  224.  
  225. Inserts the text in the buffer in the place(s) marked.
  226.  
  227. ALT_R 
  228.  
  229. Removes the block markers.
  230.  
  231. PRINTER FUNCTIONS
  232.  
  233. ALT_P
  234.  
  235. This brings up the Printer Dialog box. Here you can select the printer 
  236. (postscript or ASCII) and the number of copies. If you have postscript the 
  237. text is printed in Times Roman and looks good. Press ESC during the print to 
  238. quit.
  239.  
  240.  
  241. CALCULATORS
  242.  
  243. ALT_Q - POCKET CALCULATOR
  244. ALT_W - SPREADSHEET
  245.  
  246. TEMPLATES
  247.  
  248. ALT_A
  249.  
  250. Zeus has built in templates to place regularly used routines into your text. 
  251. Two on offer - the Menu systems can only be used with the registered version 
  252. of Zeus. The registered version of Zeus will allow blocked text to be turned 
  253. into a User Defined  templates.
  254.  
  255. SCREEN DESIGNER
  256.  
  257. ALT_S
  258.  
  259. This system allows you to generate data entry screens for your Databases. It 
  260. will, firstly, request you to select a DB. After a short(ish) pause it will 
  261. present you with a browse of the database. Press P to get the screen 
  262. designer. Use F1 to get all the help you'll need. Once the screen is 
  263. finished, F10 will save it in binary form BUT Shift_F10 will generate the
  264. Clipper 5 code to include in your programs!  
  265.  
  266. Testing your screen can be done from within the browse by pressing A.
  267.  
  268.  
  269.  
  270. DATA BASE UTILITY
  271.  
  272. ALT_F2 - starts the utility
  273.  
  274. As stated above, this utility does not fly - due to memoedit grabbing the 
  275. best of the memory resources. However, this utility supports the CDX driver, 
  276. which is a big plus over the DBU supplied with Clipper.
  277.  
  278. This utility is a tool, and does not emulate all of the DBU features - it 
  279. can only have one file open at a time, so you cannot use SET RELATION TO 
  280. etc.
  281.  
  282. This utility is totally MENU driven.  
  283.  
  284. GETTING STARTED
  285.  
  286. When you enter the DBU it is CDX mode (see the box on the right hand of the 
  287. screen). 
  288.  
  289. Now MOST databases created with the NTX format can be read by the CDX driver 
  290. and vice-versa. The exception is when the DB contains a memo field. The 
  291. default Clipper response is to say 'DataBase corruption detected' and then 
  292. bug out. DBU however, if it cannot read the DB using the NTX driver will 
  293. switch to the CDX. If the DB still wont open you will get a message stating 
  294. the DB can't be opened and the program then resumes - no bugging out!
  295.  
  296. One thing - the CDX driver CANNOT read NTX Index Files and the NTX driver 
  297. won't read IDX or CDX indexes. Therefore, the first thing to do is to set 
  298. the Default driver to the right one - use the Set Default menu prompt.
  299.  
  300. Then open the file and indexe(s).
  301.  
  302. The browse function is the same as in the screen designer. If, however, you 
  303. have more than one index open (or a CDX index containing more than one tag), 
  304. pressing ALT_I from within the browse will switch to the next index.
  305.  
  306. Most of the functions available are easy to understand and use. Most will 
  307. prompt you for the input - as in Create / amend file function.
  308.  
  309. RTOPC ??
  310.  
  311. Users who have the job of getting data from an AS400 can use this to go to 
  312. the PC support function. If you don't use an AS400 ignore this.
  313.  
  314. CREATE FROM FDF
  315.  
  316. Another AS400 function. The AS400 created a Format Definition File (FDF) 
  317. when it puts data on the PC. This function will create a new database from 
  318. the information in the FDF. This saves stacks of time typing in field names 
  319. and types etc.
  320.  
  321. APPEND
  322.  
  323. The append function starts with a database append as its default.
  324.  
  325. To change the mode - use the space bar when the input bar is over 
  326. 'DATABASE'. Similar use of the spacebar toggles the other defaults.
  327.  
  328. ****************************************************************************
  329.  
  330. That's about it for the instructions. If you have any questions please 
  331. either write or leave me a message on a BBS (QBS for example). DO NOT PHONE 
  332. me up or you will experience the wrath of my wife and you won't enjoy that 
  333. at all...
  334.  
  335. Send your £15 to :
  336.  
  337. A W Bell
  338. 26a Meadow Way
  339. WoodHatch 
  340. Reigate Surrey
  341. RH2 8DR
  342.  
  343.  
  344.  
  345.  
  346.                 
  347.